git rebase 交互式操作

概述 ​

交互式 rebase（git rebase -i）是 Git 中最强大的提交历史管理工具之一，允许你在 rebase 过程中编辑、删除、合并、重排序提交，从而创建更加清晰和有条理的提交历史。这对于整理本地提交、准备代码审查或优化项目历史非常有用。

什么是交互式 Rebase？ ​

交互式 rebase 是 rebase 的一种特殊模式，它会打开一个编辑器，让你选择对每个提交执行什么操作。你可以：

• pick：保留提交（默认）
• edit：编辑提交（修改内容或提交信息）
• squash：将提交合并到前一个提交
• fixup：类似 squash，但丢弃提交信息
• drop：删除提交
• reword：只修改提交信息
• exec：执行 shell 命令

基本用法 ​

基本语法 ​

# 交互式 rebase 最近 N 个提交
git rebase -i HEAD~N

# 交互式 rebase 到指定提交
git rebase -i <commit-hash>

# 交互式 rebase 到指定分支
git rebase -i <base-branch>

常用命令 ​

# 编辑最近 3 个提交
git rebase -i HEAD~3

# 编辑从某个提交到当前的所有提交
git rebase -i abc123

# 编辑从 main 分支分叉后的所有提交
git rebase -i main

交互式编辑器界面 ​

执行 git rebase -i 后，会打开编辑器显示类似以下内容：

pick abc123 添加用户登录功能
pick def456 修复登录 bug
pick ghi789 优化登录性能

# Rebase 1234567..ghi789 onto 1234567 (3 commands)
#
# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# e, edit <commit> = use commit, but stop for amending
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup <commit> = like "squash", but discard this commit's log message
# d, drop <commit> = remove commit
# x, exec <command> = run command (the rest of the line) using shell
# b, break = stop here (continue rebase later with 'git rebase --continue')
# ...

常用操作 ​

1. 修改提交信息（reword） ​

将提交列表中的 pick 改为 reword（或 r）：

reword abc123 添加用户登录功能
pick def456 修复登录 bug
pick ghi789 优化登录性能

保存后，Git 会依次打开编辑器让你修改每个提交的信息。

2. 编辑提交内容（edit） ​

将 pick 改为 edit（或 e）：

edit abc123 添加用户登录功能
pick def456 修复登录 bug
pick ghi789 优化登录性能

保存后，Git 会在该提交处暂停，你可以：

# 修改文件
# ... 进行修改 ...

# 修改暂存区
git add <修改的文件>

# 修改提交
git commit --amend

# 继续 rebase
git rebase --continue

3. 合并提交（squash） ​

将多个提交合并为一个：

pick abc123 添加用户登录功能
squash def456 修复登录 bug
squash ghi789 优化登录性能

保存后，Git 会打开编辑器让你编辑合并后的提交信息。

4. 合并提交并丢弃信息（fixup） ​

类似 squash，但自动使用前一个提交的信息：

pick abc123 添加用户登录功能
fixup def456 修复登录 bug
fixup ghi789 优化登录性能

保存后，def456 和 ghi789 的更改会合并到 abc123，但提交信息保持不变。

5. 删除提交（drop） ​

删除不需要的提交：

pick abc123 添加用户登录功能
drop def456 修复登录 bug
pick ghi789 优化登录性能

或者直接删除该行：

pick abc123 添加用户登录功能
pick ghi789 优化登录性能

6. 重排序提交 ​

直接调整提交的顺序：

pick ghi789 优化登录性能
pick abc123 添加用户登录功能
pick def456 修复登录 bug

保存后，提交会按照新顺序重新应用。

工作流程示例 ​

场景 1：整理最近 5 个提交 ​

1. 启动交互式 rebase

   bash

   git rebase -i HEAD~5

   1
   

2. 在编辑器中调整提交

   text

   pick abc123 初始提交
   reword def456 临时提交
   squash ghi789 修复 typo
   fixup jkl012 再次修复
   pick mno345 重要功能

   1
   2
   3
   4
   5
   

3. 保存并关闭编辑器

4. 根据操作类型，Git 会：

   • 对 reword 提交打开编辑器修改信息
   • 对 squash 提交打开编辑器编辑合并信息
   • 自动处理 fixup 提交

5. 完成 rebase

   bash

   git rebase --continue  # 如果需要

   1
   

场景 2：拆分提交 ​

1. 启动交互式 rebase，将目标提交改为 edit

   text

   edit abc123 添加登录和注册功能
   pick def456 其他提交

   1
   2
   

2. Git 暂停后，重置提交但保留更改

   bash

   git reset HEAD~1

   1
   

3. 选择性暂存和提交

   bash

   # 暂存登录相关文件
   git add src/login.js
   git commit -m "添加用户登录功能"
   
   # 暂存注册相关文件
   git add src/register.js
   git commit -m "添加用户注册功能"

   1
   2
   3
   4
   5
   6
   7
   

4. 继续 rebase

   bash

   git rebase --continue

   1
   

场景 3：修改历史提交的内容 ​

1. 启动交互式 rebase，将目标提交改为 edit

   text

   pick abc123 提交 1
   edit def456 需要修改的提交
   pick ghi789 提交 3

   1
   2
   3
   

2. Git 暂停后，进行修改

   bash

   # 修改文件
   # ... 进行修改 ...
   
   # 添加到暂存区
   git add <修改的文件>
   
   # 修改提交
   git commit --amend
   
   # 继续 rebase
   git rebase --continue

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   

常用选项 ​

实用技巧 ​

1. 使用 autosquash 自动合并 ​

在提交信息中使用 fixup! 或 squash! 前缀：

# 创建一个 fixup 提交
git commit -m "fixup! 添加用户登录功能"

# 使用 autosquash 自动合并
git rebase -i --autosquash HEAD~5

Git 会自动将 fixup 提交合并到对应的提交中。

2. 修改编辑器 ​

设置交互式 rebase 使用的编辑器：

# 使用 VS Code
git config --global core.editor "code --wait"

# 使用 vim
git config --global core.editor "vim"

# 使用 nano
git config --global core.editor "nano"

3. 在 rebase 过程中执行命令 ​

使用 exec 命令在 rebase 过程中执行 shell 命令：

pick abc123 提交 1
exec npm test
pick def456 提交 2
exec npm run lint

4. 暂停 rebase ​

使用 break 命令暂停 rebase：

pick abc123 提交 1
break
pick def456 提交 2

暂停后可以执行其他操作，然后使用 git rebase --continue 继续。

注意事项 ​

1. 只对本地提交使用交互式 rebase：

   • 不要对已推送到远程的提交使用交互式 rebase（除非团队约定）
   • 已共享的提交历史不应该被改写

2. 备份重要分支：

   • 在执行交互式 rebase 前创建备份：

     bash

     git branch feature-backup

     1
     

3. 理解提交顺序：

   • 交互式编辑器中的提交顺序是从旧到新（最旧的在上）
   • 调整顺序时要考虑提交之间的依赖关系

4. 冲突处理：

   • 在交互式 rebase 过程中可能遇到冲突
   • 解决冲突后使用 git add 和 git rebase --continue 继续

5. 提交哈希会改变：

   • 任何修改（包括 reword）都会改变提交哈希
   • 这是正常现象，因为提交对象被重新创建了

常见错误和解决方案 ​

错误：编辑器无法打开 ​

问题： 执行 git rebase -i 后没有打开编辑器

解决方案：

# 设置编辑器
git config --global core.editor "code --wait"  # VS Code
# 或
git config --global core.editor "vim"  # vim

错误：rebase 过程中想修改待办列表 ​

解决方案：

git rebase --edit-todo  # 重新编辑待办列表

错误：想撤销交互式 rebase ​

解决方案：

git rebase --abort  # 恢复到 rebase 前的状态

错误：在 edit 模式下不知道下一步 ​

解决方案：

# 查看当前状态
git status

# 如果需要修改提交
git add <文件>
git commit --amend

# 如果不需要修改，直接继续
git rebase --continue

应用场景 ​

• 整理提交历史：在推送前合并相关的提交，使历史更加清晰
• 修改提交信息：修正拼写错误或改进提交信息的描述
• 拆分大提交：将一个大提交拆分为多个逻辑清晰的小提交
• 删除无用提交：移除临时提交、调试代码或错误的提交
• 重排序提交：按照逻辑顺序重新排列提交，使历史更易理解
• 准备代码审查：在提交 PR 前整理提交，提高审查效率

最佳实践 ​

1. 频繁整理：在推送前经常使用交互式 rebase 整理提交
2. 保持提交小而专注：每个提交应该只做一件事
3. 清晰的提交信息：使用有意义的提交信息，遵循团队规范
4. 测试后再推送：交互式 rebase 后运行测试，确保没有问题
5. 与团队沟通：如果需要对已共享的提交使用 rebase，先与团队沟通

小结 ​

交互式 rebase 是 Git 中最强大的提交历史管理工具，通过 git rebase -i 可以精细控制提交历史。掌握交互式 rebase 后，你可以创建更加清晰、有条理的提交历史，提高代码审查效率。记住：只对本地提交使用交互式 rebase，这是最重要的原则。

下一篇文章将介绍 rebase 在实际项目中的应用场景，以及与 merge 的选择策略。